- release_tracks: [ALPHA, BETA, GA]
  deprecate:
    is_removed: false
    warning: |
      Security Command Center Asset APIs are deprecated and will be removed on or after
      June 26, 2024. Use Cloud Asset Inventory instead [(gcloud asset)](https://cloud.google.com/sdk/gcloud/reference/asset).
      For more information, [see the deprecation notice at Assets Page](https://cloud.google.com/security-command-center/docs/how-to-use-security-command-center#assets_page).
  # This command calls a list operation behind the scenes but we can't make command_type as list
  # since it doesn't support any of the list-flags.
  command_type: GENERIC
  generic:
    disable_paging_flags: true

  help_text:
    brief: Describe an asset given its resource name or asset id.
    description: Describe an asset given its resource name or asset id.
    examples: |
      Describe an asset under organization 123456, given its full resource name (https://cloud.google.com/apis/design/resource_names#full_resource_name) e.g. //storage.googleapis.com/my-bucket:

        $ {command} 123456 --resource-name="//storage.googleapis.com/my-bucket"

      Describe an asset under organization 123456, given its Cloud SCC asset id 5678

        $ {command} 123456 --asset=5678

      Describe an asset under project example-project, given its Cloud SCC asset id 5678

        $ {command} projects/example-project/assets/5678

      Describe an asset under folder 456, given its Cloud SCC asset id 5678

        $ {command} folders/456/assets/5678

  request:
    collection: securitycenter.organizations.assets
    api_version: v1
    method: list
    modify_request_hooks:
    - googlecloudsdk.command_lib.scc.assets.request_hooks:DescribeAssetReqHook

  arguments:
    additional_arguments_hook: googlecloudsdk.command_lib.scc.hooks:AppendParentArg

    params:
    - group:
        mutex: true
        required: true
        params:
        - arg_name: asset
          help_text: |
            Cloud SCC specific asset. It's derived from the the asset's relative resource name.
            See: https://cloud.google.com/apis/design/resource_names#relative_resource_name.
            For Example, for the given asset name: "organizations/123/assets/456", 456 represents
            asset id.
        - arg_name: resource-name
          help_text: |
            Asset's resource name. Full resource name of the Google Cloud Platform resource
            this asset represents. This field is immutable after create time. See:
            https://cloud.google.com/apis/design/resource_names#full_resource_name.
            For Example: "//cloudresourcemanager.googleapis.com/projects/1234567890123" could be the
            resource-name for a project.

  response:
    modify_response_hooks:
    - googlecloudsdk.command_lib.scc.assets.response_hooks:ExtractMatchingAssetFromDescribeResponse